Skip to main content

Universal App Setup and Running Guide

Prerequisites​

  • Android Studio installed (for Android development)
  • Xcode installed (for iOS development)
  • Node.js and npm installed
  • Android SDK configured (for Android)
  • iOS Simulator set up (for iOS)

Running the App​

  1. Create Catalyst App (if not already created)
npx [email protected]
  1. Getting Local IP Address
# Navigate to your project directory
cd your-project-directory

# For Mac OS X

# Method 1: Using ifconfig
ifconfig | grep "inet " | grep -v 127.0.0.1

# Method 2: Using ip command (Linux)
ip addr show | grep "inet "
  1. Configuration Setup Replace localhost with your actual local IP address (e.g., 192.168.1.100)
{
  ...
  "NODE_SERVER_HOSTNAME": "YOUR_LOCAL_IP",
  "WEBPACK_DEV_SERVER_HOSTNAME": "YOUR_LOCAL_IP",
  "PUBLIC_STATIC_ASSET_URL": "http://YOUR_LOCAL_IP:3005"
  ...
}
  1. Set up Emulator

Refer following for detailed instructions on how to set up the Emulator

  1. Build and Run
# Start the development server
npm run start

# In a new terminal, build the app

# For Android
npm run buildApp:android

# For iOS
npm run buildApp:ios

Useful Commands​

# List all simulators
xcrun simctl list

# List available runtimes
xcrun simctl list runtimes --json

# List device types
xcrun simctl list devicetypes --json

# Open Simulator app
open -a Simulator

# Shutdown all simulators
xcrun simctl shutdown all

# Get simulator's ID
xcrun simctl list | grep "iPhone 16 Pro" | grep -E -o -i "([0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12})"

# Boot specific simulator
xcrun simctl boot DEVICE_UUID

# Install app on booted simulator
xcrun simctl install booted /path/to/your/app.app

# Launch app on simulator
xcrun simctl launch booted your.app.bundle.id

Important Notes​

  • The local IP address might change when switching networks
  • Some corporate networks might block required ports
  • Keep your SDK tools and development environment updated
  • Always backup your configuration files before making changes